package top.lixunda.ecommerce.server.good.api.controller;

import com.baomidou.mybatisplus.core.metadata.IPage;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.*;
import top.lixunda.commerce.common.core.entity.MessageObject;
import top.lixunda.common.validate.XumValid;
import top.lixunda.ecommerce.server.business.api.entity.dto.PageDTO;
import top.lixunda.ecommerce.server.good.api.entity.db.SimpleReviewDetailDO;
import top.lixunda.ecommerce.server.good.api.entity.dto.SimpleReviewInsertDTO;
import top.lixunda.ecommerce.server.good.api.entity.dto.SimpleReviewQueryDTO;
import top.lixunda.ecommerce.server.good.api.entity.vo.SimpleReviewVO;

import java.util.List;

/**
 * 简单评论
 *
 * @author Xumda
 * @version time:2020/1/14 15:45
 */
@SuppressWarnings("unused")
@Api("简单评论")
@RequestMapping("/simple_review")
public interface ISimpleReviewController {

    /**
     * 根据id查询单个评论信息
     *
     * @param id 评论id
     * @return 评论信息
     */
    @ApiOperation("根据id查询单个评论信息")
    @GetMapping("queryReviewById")
    MessageObject<SimpleReviewVO> queryReviewById(@RequestParam("id") Integer id);

    /**
     * 根据多个id查询多个评论信息
     *
     * @param ids 多个评论id
     * @return 多个评论信息
     */
    @ApiOperation("根据多个id查询多个评论信息")
    @PostMapping("queryReviewsByIds")
    MessageObject<List<SimpleReviewVO>> queryReviewsByIds(@RequestBody List<Integer> ids);

    /**
     * 查询某个商品的简单评论
     *
     * @param id 商品id
     * @return 评论信息
     */
    @ApiOperation("查询某个商品的简单评论")
    @GetMapping("queryReviewByGoodId")
    MessageObject<List<SimpleReviewVO>> queryReviewByGoodId(@RequestParam("id") Integer id);

    /**
     * 分页查询某个商品的简单评论
     *
     * @param pageDTO 分页数据, 包含条件
     * @return 分页数据
     */
    @ApiOperation("分页查询某个商品的简单评论")
    @PostMapping("queryReviewWrapperPage")
    MessageObject<IPage<SimpleReviewVO>> queryReviewWrapperPage(
            @RequestBody @XumValid PageDTO<SimpleReviewDetailDO, SimpleReviewQueryDTO> pageDTO);

    /**
     * 对某一个商品添加一条评论信息
     *
     * @param simpleReviewInsertDTO 商品评论信息
     * @return 添加成功的评论信息
     */
    @ApiOperation("对某一个商品添加一条评论信息")
    @PostMapping("addReview")
    MessageObject<SimpleReviewVO> addReview(@RequestBody @XumValid SimpleReviewInsertDTO simpleReviewInsertDTO);

}
